Skip to content
forked from rust-cli/confy

πŸ›‹ Zero-boilerplate configuration management in Rust

License

Notifications You must be signed in to change notification settings

rustdesk-org/confy

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

93 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

confy

crates.io docs.rs Discord

Zero-boilerplate configuration management.

Focus on storing the right data, instead of worrying about how or where to store it.

use serde_derive::{Serialize, Deserialize};

#[derive(Default, Debug, Serialize, Deserialize)]
struct MyConfig {
    version: u8,
    api_key: String,
}

fn main() -> Result<(), ::std::io::Error> {
    let cfg: MyConfig = confy::load("my-app-name", None)?;
    dbg!(cfg);
    Ok(())
}

Using yaml

Enabling the yaml_conf feature while disabling the default toml_conf feature causes confy to use a YAML config file instead of TOML.

[dependencies.confy]
features = ["yaml_conf"]
default-features = false

Breaking changes

Version 0.5.0

  • As directories stopped being maintained we switch to directories-next. Both crates released a breaking change regarding default configuration path change on macos. For further information check their changelog.
  • The base functions load and store have been added an optional parameter in the event multiples configurations are needed, or ones with different filename.
  • The default configuration file is now named "default-config" instead of using the application's name. Put the second argument of load and store to be the same of the first one to keep the previous configuration file.
  • It is now possible to save the configuration as toml or as yaml. The configuration's file name's extension depends on the format used.

Version 0.4.0

Starting with version 0.4.0 the configuration file are stored in the expected place for your system. See the directories crates for more information. Before version 0.4.0, the configuration file was written in the current directory.

About

πŸ›‹ Zero-boilerplate configuration management in Rust

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 100.0%